home *** CD-ROM | disk | FTP | other *** search
/ Language/OS - Multiplatform Resource Library / LANGUAGE OS.iso / lisp / clue.lha / clue / doc / clue.tex / node111_mn.html < prev    next >
Text File  |  1989-07-12  |  4KB  |  129 lines
  1.  
  2. <H3><A ID="SECTION003311100000000000000"><tex2html_anchor_invisible_mark></A> <A ID="ch:contact-display"><tex2html_anchor_mark></A><BR>
  3. The Contact Display
  4. </H3><#4978#>
  5.            
  6.       
  7.  
  8. The <#1157#><TT>contact-display</TT><#1157#> object type defines the fundamental mechanisms for
  9. associating
  10. a contact  with a CLX <#1158#><TT>xlib:display</TT><#1158#><A ID="1159"><tex2html_anchor_invisible_mark></A> object and for dispatching
  11. interactive input events to the contacts which will process them.
  12.  
  13. <P>
  14. A <#1160#><TT>contact-display</TT><#1160#> object inherits the behavior of a CLX <#1161#><TT>display</TT><#1161#> object<A ID="1162"><tex2html_anchor_invisible_mark></A>
  15. and can be substituted wherever a 
  16. <#1163#><TT>xlib:display</TT><#1163#> is allowed<A NAME="tex2html147" HREF="#footfnm1" TARGET="footer"><SUP>30.1</SUP></A>.  An application will usually create a single <#1165#><TT>contact-display</TT><#1165#> which
  17. represents the connection through which requests are sent to an X server<A ID="1166"><tex2html_anchor_invisible_mark></A> and input events are received.
  18.  
  19. <P>
  20. The basic operations on a <#1167#><TT>contact-display</TT><#1167#> are listed below and are
  21. described in detail in other
  22. parts of this document.  
  23.  
  24. <UL>
  25. <LI>Read and process an input event (see Section~<A HREF=<tex2html_cr_mark>#ch:event-loop#1169><tex2html_cr_mark></A>).
  26. </LI>
  27. <LI>Read character input from interactive stream contacts (see
  28. Section~<A HREF=<tex2html_cr_mark>#ch:multiple-stream-input#1170><tex2html_cr_mark></A>).
  29. </LI>
  30. <LI>Establish global processing of input events (see
  31. Section~<A HREF=<tex2html_cr_mark>#ch:global-event-processing#1171><tex2html_cr_mark></A>).
  32. </LI>
  33. <LI>Inquire the available display roots (see Section~<A HREF=<tex2html_cr_mark>#ch:roots#1172><tex2html_cr_mark></A>).
  34. </LI>
  35. <LI>Inquire or change the default display root (see
  36. Section~<A HREF=<tex2html_cr_mark>#ch:roots#1173><tex2html_cr_mark></A>).  
  37. </LI>
  38. </UL>
  39.  
  40. <P>
  41. The <#1175#><TT>open-contact-display</TT><#1175#> function is used to create a <#1176#><TT>contact-display</TT><#1176#> object and to connect it to an X server.<A ID="1177"><tex2html_anchor_invisible_mark></A>
  42.  
  43. <P>
  44. <#4255#><FONT SIZE="+1"><#1178#><B>open-contact-display Function</B><#1178#></FONT><#4255#> 
  45. <A ID="1179"><tex2html_anchor_invisible_mark></A>
  46. <DIV class="RIGHT">
  47. <tex2html_image_mark>#tex2html_wrap_inline9891#
  48. </DIV>
  49.  
  50. <P>
  51. <DIV class="RIGHT">
  52. <tex2html_image_mark>#tex2html_wrap_inline9892#
  53. </DIV>
  54.  
  55. <P>
  56. <DIV class="RIGHT">
  57. <tex2html_image_mark>#tex2html_wrap_inline9893#
  58. </DIV>
  59.  
  60. <P>
  61. <DIV class="RIGHT">
  62. <tex2html_image_mark>#tex2html_wrap_inline9894#
  63. </DIV>
  64.  
  65. <P>
  66. <DIV class="RIGHT">
  67. <A NAME="tex2html148" HREF="#footfnm2" TARGET="footer"><tex2html_image_mark>#tex2html_wrap_inline9895#</A>
  68. </DIV>
  69.  
  70.  
  71. <P>
  72. <DIV class="RIGHT">
  73. <tex2html_image_mark>#tex2html_wrap_inline9897#
  74. </DIV>
  75.  
  76. <P>
  77. <DIV class="RIGHT">
  78. <tex2html_image_mark>#tex2html_wrap_inline9898#
  79. </DIV>
  80.  
  81. <P>
  82. <DIV class="RIGHT">
  83. <tex2html_image_mark>#tex2html_wrap_inline9899#
  84. </DIV>
  85.  
  86. <P>
  87. <DIV class="RIGHT">
  88. <tex2html_image_mark>#tex2html_wrap_inline9900#
  89. </DIV>
  90.  
  91. <P>
  92. <DIV class="RIGHT">
  93. <tex2html_image_mark>#tex2html_wrap_inline9901#
  94. </DIV>
  95.  
  96. <P>
  97. <DIV class="RIGHT">
  98. <tex2html_image_mark>#tex2html_wrap_inline9902#
  99. </DIV>
  100.  
  101. <P>
  102. <#4654#>
  103. <#4267#><FONT SIZE="+1"><#1275#><B>*default-host* Variable</B><#1275#></FONT><#4267#> 
  104. <A ID="1276"><tex2html_anchor_invisible_mark></A><A ID="1277"><tex2html_anchor_invisible_mark></A>
  105. <DIV class="RIGHT">
  106. <tex2html_image_mark>#tex2html_wrap_inline9903#
  107. </DIV><#4654#>
  108.  
  109. <P>
  110. <DIV class="RIGHT">
  111. <tex2html_image_mark>#tex2html_wrap_inline9906#
  112. </DIV>
  113.  
  114. <P>
  115. <#4655#>
  116. <#4270#><FONT SIZE="+1"><#1292#><B>*default-display* Variable</B><#1292#></FONT><#4270#> 
  117. <A ID="1293"><tex2html_anchor_invisible_mark></A><A ID="1294"><tex2html_anchor_invisible_mark></A>
  118. <DIV class="RIGHT">
  119. <tex2html_image_mark>#tex2html_wrap_inline9907#
  120. </DIV><#4655#>
  121.  
  122. <P>
  123. <DIV class="RIGHT">
  124. <tex2html_image_mark>#tex2html_wrap_inline9910#
  125. </DIV>
  126.  
  127. <P>
  128.  
  129.  =0 <#4988#>=0 <#4992#>